Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Data Encryption Workshop/ Referencia de la API/ Ejemplos de aplicación/ Ejemplo 3: Consulta de información sobre claves

Actualización más reciente 2022-11-03 GMT+08:00

Ver PDF

Ejemplo 3: Consulta de información sobre claves

Escenario

Utilice las API de KMS para obtener la lista de claves, información clave, instancias clave y etiquetas clave.

APIs involucradas

Lista de claves de consulta
Consultar información clave
Consultar instancia de clave
Consultar etiquetas de clave Tag Management Service (TMS) debe consultar todas las etiquetas de un CMK especificado.

Procedimiento

Consultar la lista de claves.

Información de API
URI format: POST /v1.0/{project_id}/kms/list-keys

Para obtener más información, consulte "Consulta de lista de claves".
Ejemplo de solicitud
POST: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/list-keys

Obtenga {endpoint} de Regiones y Puntos de conexión.

Body:
```
{  
   "limit": "2", 
    "marker": "1"
 }
```

Ejemplo de respuesta

{ 
    "keys": [
         "0d0466b0-e727-4d9c-b35d-f84bb474a37f", 
        "2e258389-bb1e-4568-a1d5-e1f50adf70ea"
     ],
     "key_details": [ 
     {   
      "key_id":"0d0466b0-e727-4d9c-b35d-f84bb474a37f",  
       "domain_id":"00074811d5c27c4f8d48bb91e4a1dcfd",
         "key_alias":"caseuirpr",
         "realm":"aaaa",
         "key_description":"123", 
        "creation_date":"1502799822000",
         "scheduled_deletion_date":"",
         "key_state":"2",
         "default_key_flag":"0",
         "key_type":"1",
         "expiration_time":"1501578672000",
         "origin":"kms"
 }, 
        {   
      "key_id":"2e258389-bb1e-4568-a1d5-e1f50adf70ea",  
       "domain_id":"00074811d5c27c4f8d48bb91e4a1dcfd",  
       "key_alias":"casehvniz",
        "realm":"aaaa",   
      "key_description":"234", 
        "creation_date":"1502799820000", 
         "scheduled_deletion_date":"",
         "key_state":"2",
         "default_key_flag":"0",
         "key_type":"1", 
        "expiration_time":"1501578673000",
         "origin":"kms"
 }
      ],
     "next_marker": "", 
    "truncated": "false",
     "total":2 
}

Consultar la información acerca de las claves.

Información de API
Formato de URI: POST /v1.0/{project_id}/kms/describe-key

Para obtener más información, consulte "Consultar detalles de clave".
Ejemplo de solicitud
POST: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/describe-key

Obtenga {endpoint} de Regiones y Puntos de conexión.

Puede utilizar la API para consultar la lista de CMK para comprobar la información clave, incluido key_id.

Body:
```
{  
   "key_id": "0d0466b0-e727-4d9c-b35d-f84bb474a37f" 
}
```

Ejemplo de respuesta

{ 
    "key_info": { 
        "key_id": "0d0466b0-e727-4d9c-b35d-f84bb474a37f", 
        "domain_id": "b168fe00ff56492495a7d22974df2d0b", 
        "key_alias": "kms_test", 
        "realm": "aaa",
         "key_description": "",  
       "creation_date": "1472442386000", 
        "scheduled_deletion_date": "", 
        "key_state": "2", 
        "default_key_flag": "0", 
        "key_type": "1", 
        "expiration_time":"1501578672000", 
        "origin":"kms", 
        "key_rotation_enabled":"false", 
        "sys_enterprise_project_id ": "0",
     }
 }

Consultar instancias CMK.

Información de API
Formato URI: POST /v1.0/{project_id}/kms/resource_instances/action

Para obtener más información, consulte "Consultar instancias de clave".

Ejemplo de solicitud

POST: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms//resource_instances/action

Obtenga {endpoint} de Regiones y Puntos de conexión.

Body:

   { 
          "offset": "100",  
          "limit": "100",  
          "action": "filter",
            "matches":[   
        {    
                "key": "resource_name",  
                   "value": "resource1"    
             }  
          ],  
          "tags": [  
              {      
              "key": "key1",    
                 "values": [    
                         "value1",   
                           "value2"   
                 ]  
              }   
        ]   
   }

Ejemplo de respuesta

{
  "resources" : [ {
    "resource_id" : "90c03e67-5534-4ed0-acfa-89780e47a535",
    "resource_detail" : [ {
      "key_id" : "90c03e67-5534-4ed0-acfa-89780e47a535",
      "domain_id" : "4B688Fb77412Aee5570E7ecdbeB5afdc",
      "key_alias" : "tagTest_xmdmi",
      "key_description" : "123",
      "creation_date" : 1521449277000,
      "scheduled_deletion_date" : "",
      "key_state" : 2,
      "default_key_flag" : 0,
      "key_type" : 1,
      "key_rotation_enabled" : false,
      "expiration_time" : "",
      "origin" : "kms",
      "sys_enterprise_project_id" : "0",
      "realm" :  "cn-hongkong-7"
    } ],
    "resource_name" : "tagTest_xmdmi",
    "tags" : [ {
      "key" : "key",
      "value" : "testValue!"
    }, {
      "key" : "haha",
      "value" : "testValue"
    } ]
  } ],
  "total_count" : 1
}

Consultar las etiquetas de una clave.
- Información de API
  Formato URI: GET /v1.0/{project_id}/kms/{key_id}/tags
  
  Para obtener más información, consulte "Consultar etiquetas de clave".
- Ejemplo de solicitud
  GET: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/94752282-805e-4032-ada8-34966f70e02f/tags
  
  Obtenga {endpoint} de Regiones y Puntos de conexión.
  
  Body:
  
  Ninguno
- Ejemplo de respuesta
```
{ 
        "tags": [   
         {   
          "key": "key1",   
          "value": "value1" 
           }, 
           {  
           "key": "key2",  
           "value": "value3" 
           } 
           ], 
           "existTagsNum":2  
}
```