DescribePolicyInstances - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Consulta as informações detalhadas sobre instâncias de política do tipo especificado em um cluster do Container Service for Kubernetes (ACK), como a descrição da política e o nível de severidade. Você pode escolher um tipo de política de segurança para um cluster ACK, especificar a ação e o escopo aplicável da política e, em seguida, criar e implantar uma instância de política.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:DescribePolicyInstances

get

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

Nenhuma

Sintaxe da solicitação

GET /clusters/{cluster_id}/policies HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
cluster_id	string	Sim	O ID do cluster.	c8155823d057948c69a****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
policy_name	string	Não	O nome da política que você deseja consultar.	ACKPSPCapabilities
instance_name	string	Não	O nome da instância de política que você deseja consultar.	allowed-repos-cz4s2

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	array	Uma lista de instâncias de política.
	object	A instância de política.
ali_uid	string	O UID da conta Alibaba Cloud usada para implantar a instância de política.	16298168****
cluster_id	string	O ID do cluster.	c8155823d057948c69a****
instance_name	string	O nome da instância de política.	no-env-var-secrets-****
policy_name	string	O nome da política.	ACKPSPCapabilities
policy_category	string	O tipo da política.	k8s-general
policy_description	string	A descrição do modelo de política.	Restricts secrets used in pod envs
policy_parameters	string	Os parâmetros da instância de política.	"restrictedNamespaces": [ "test" ]
policy_severity	string	O nível de severidade da instância de política.	low
policy_scope	string	O escopo aplicável da instância de política. Um valor de * indica todos os namespaces no cluster. Este é o valor padrão. Vários namespaces são separados por vírgulas (,).	*
policy_action	string	A ação da política. Valores válidos: `deny`: As implantações que correspondem à política são negadas. `warn`: Alertas são gerados para implantações que correspondem à política.	deny
Created `deprecated`	string	A hora de criação da instância. Este parâmetro está descontinuado.	2024-10-29T18:09:12+08:00
Updated `deprecated`	string	A hora de atualização da instância. Este parâmetro está descontinuado.	2024-10-29T18:09:12+08:00
resource_id `deprecated`	string	O ID do recurso. Este parâmetro está descontinuado.	123456***
total_violations `deprecated`	integer	O número de violações processadas no cluster. Este parâmetro está descontinuado.	0
is_deleted `deprecated`	integer	O status da exclusão. Este parâmetro está descontinuado.	0

Exemplos

Resposta de sucesso

JSON formato

[
  {
    "ali_uid": "16298168****",
    "cluster_id": "c8155823d057948c69a****",
    "instance_name": "no-env-var-secrets-****",
    "policy_name": "ACKPSPCapabilities",
    "policy_category": "k8s-general",
    "policy_description": "Restricts secrets used in pod envs",
    "policy_parameters": "\"restrictedNamespaces\": [ \"test\" ]",
    "policy_severity": "low",
    "policy_scope": "*",
    "policy_action": "deny",
    "Created": "2024-10-29T18:09:12+08:00",
    "Updated": "2024-10-29T18:09:12+08:00",
    "resource_id": "123456***",
    "total_violations": 0,
    "is_deleted": 0
  }
]

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.