UntagResource - : Central de Documentação do Alibaba Cloud

Descrição da operação

Use esta operação para remover tags por chave de um recurso do KMS. Especifique apenas as chaves das tags a remover; os valores das tags não são necessários.

Cada solicitação tem como alvo exatamente um recurso. Especifique um dos seguintes parâmetros: KeyId, SecretName ou CertificateId. Não é possível configurar mais de um desses parâmetros na mesma solicitação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UntagResource	A operação a ser executada. Defina o valor como UntagResource.
KeyId	String	Não	08c33a6f-4e0a-4a1b-a3fa-7ddf****	O ID da CMK. O ID deve ser globalmente único. Nota Especifique apenas um entre `KeyId`, `SecretName` ou `CertificateId`.
SecretName	String	Não	MyDbC****	O nome do segredo. Nota Especifique apenas um entre `KeyId`, `SecretName` ou `CertificateId`.
CertificateId	String	Não	770dbe42-e146-43d1-a55a-1355db86****	O ID do certificado. Nota Especifique apenas um entre `KeyId`, `SecretName` ou `CertificateId`.
TagKeys	String	Sim	["tagkey1","tagkey2"]	As chaves das tags a remover. Separe várias chaves com vírgulas (,). Especifique apenas as chaves das tags, não os valores. Cada chave de tag deve ter de 1 a 128 bytes.

Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos da resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	4162a6af-bc99-40b3-a552-89dcc8aaf7c8	O ID da solicitação, usado para localizar e solucionar problemas.

Exemplos

O exemplo a seguir remove as tags com as chaves tagkey1 e tagkey2 da CMK cujo ID é 08c33a6f-4e0a-4a1b-a3fa-7ddf****.

Exemplo de solicitação

http(s)://[Endpoint]/?Action=UntagResource
&KeyId=08c33a6f-4e0a-4a1b-a3fa-7ddf****
&TagKeys=["tagkey1","tagkey2"]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UntagResourceResponse>
    <RequestId>4162a6af-bc99-40b3-a552-89dcc8aaf7c8</RequestId>
</UntagResourceResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4162a6af-bc99-40b3-a552-89dcc8aaf7c8"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified parameter is not valid.	Um valor inválido foi especificado para um parâmetro.
404	InvalidAccessKeyId.NotFound	The Access Key ID provided does not exist in our records.	O AccessKey ID especificado não existe.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.