Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Data Encryption Workshop> Referência de API> Exemplos de aplicação> Exemplo 3: consulta de informações sobre chaves

Atualizado em 2023-02-28 GMT+08:00

Ver PDF

Exemplo 3: consulta de informações sobre chaves

Cenário

Use as APIs do KMS para obter a lista de chaves, informações de chave, instâncias de chave e tags de chave.

As APIs envolvidas

Consultar lista de chaves
Consultar informações da chave
Consultar instância da chave
Consultar tags da chave O Tag Management Service (TMS) precisa consultar todas as tags de uma CMK especificada.

Procedimento

Consulte a lista de chaves.

Informações da API
Formato de URI: POST /v1.0/{project_id}/kms/list-keys

Para obter detalhes, consulte "Consultar lista de chaves".
Exemplo de solicitação
POST: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/list-keys

Obtenha {endpoint} de Regiões e pontos de extremidade.

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

Exemplo de resposta

{ 
    "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 
}

Consulte as informações sobre chaves.

Informações da API
Formato de URI: POST /v1.0/{project_id}/kms/describe-key

Para obter detalhes, consulte "Consulta de detalhes da chave".
Exemplo de solicitação
POST: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/describe-key

Obtenha {endpoint} de Regiões e pontos de extremidade.

Você pode usar a API para Consulta da lista de CMKs para verificar informações de chave, incluindo key_id.

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

Exemplo de resposta

{ 
    "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 instâncias da CMK.

Informações da API
Formato de URI: POST /v1.0/{project_id}/kms/resource_instances/action

Para obter detalhes, consulte "Consulta das instâncias de chave".

Exemplo de solicitação

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

Obtenha {endpoint} de Regiões e pontos de extremidade.

Corpo:

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

Exemplo de resposta

{
  "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 as tags de uma chave.
- Informações da API
  Formato de URI: GET /v1.0/{project_id}/kms/{key_id}/tags
  
  Para obter detalhes, consulte "Consulta de tags de chave".
- Exemplo de solicitação
  GET: https://{endpoint}/v1.0/53d1aefc533f4ce9a59c26b01667cbcf/kms/94752282-805e-4032-ada8-34966f70e02f/tags
  
  Obtenha {endpoint} de Regiões e pontos de extremidade.
  
  Corpo:
  
  Nenhum
- Exemplo de resposta
```
{ 
        "tags": [   
         {   
          "key": "key1",   
          "value": "value1" 
           }, 
           {  
           "key": "key2",  
           "value": "value3" 
           } 
           ], 
           "existTagsNum":2  
}
```