ListControlPolicies - Resource Management: Central de Documentação do Alibaba Cloud

Consulta uma lista de políticas de controle.

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

resourcemanager:ListControlPolicies

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PolicyType	string	Não	O tipo da política de controle. Valores válidos: System: política de controle do sistema. Custom: política de controle personalizada.	System
PageNumber	integer	Não	O número da página. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.	10
Language	string	Não	O idioma no qual a descrição da política de controle é retornada. Valores válidos: zh-CN (padrão): chinês. en: inglês. ja: japonês. Nota Este parâmetro é válido apenas para políticas de controle do sistema.	zh-CN
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag.	tag_key
Value	string	Não	O valor da tag.	tag_value
ControlPolicyType	string	Não	O tipo da política de controle. Valores válidos: CONTROL_POLICY: política de controle. RESOURCE_CONTROL_POLICY: política de controle de recursos. Valor padrão: CONTROL_POLICY.	RESOURCE_CONTROL_POLICY

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
TotalCount	integer	O número total de políticas de controle.	1
RequestId	string	O ID da solicitação.	9424A34C-3471-45AD-B6AB-924BBDFE42F9
PageSize	integer	O número de entradas por página.	10
PageNumber	integer	O número da página.	1
ControlPolicies	object
ControlPolicy	array<object>	A lista de políticas de controle.
	array<object>	A lista de políticas de controle.
UpdateDate	string	A hora em que a política de controle foi atualizada pela última vez. A hora é exibida no formato ISO 8601, em UTC.	2020-08-05T06:32:24Z
Description	string	A descrição da política de controle.	Política de controle do sistema que suporta todas as operações da Alibaba Cloud
EffectScope	string	O escopo efetivo da política de controle. Valores válidos: All: a política de controle entra em vigor para contas da Alibaba Cloud, usuários do Resource Access Management (RAM) e funções RAM. RAM: a política de controle entra em vigor apenas para usuários e funções RAM.	All
AttachmentCount	string	O número de vezes que a política de controle é referenciada.	44
PolicyName	string	O nome da política de controle.	FullAliyunAccess
PolicyId	string	O ID da política de controle.	cp-FullAliyunAccess
CreateDate	string	A hora em que a política de controle foi criada. A hora é exibida no formato ISO 8601, em UTC.	2020-08-05T06:32:24Z
PolicyType	string	O tipo da política de controle. Valores válidos: System: política de controle do sistema. Custom: política de controle personalizada.	System
Tags	object
Tag	array<object>	As tags.
	object	As tags.
Key	string	A chave da tag.	tag_key
Value	string	O valor da tag.	tag_value
ControlPolicyType	string	O tipo da política de controle. Valores válidos: CONTROL_POLICY: política de controle. RESOURCE_CONTROL_POLICY: política de controle de recursos.	RESOURCE_CONTROL_POLICY

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "RequestId": "9424A34C-3471-45AD-B6AB-924BBDFE42F9",
  "PageSize": 10,
  "PageNumber": 1,
  "ControlPolicies": {
    "ControlPolicy": [
      {
        "UpdateDate": "2020-08-05T06:32:24Z",
        "Description": "支持阿里云所有操作的系统管控策略",
        "EffectScope": "All",
        "AttachmentCount": "44",
        "PolicyName": "FullAliyunAccess",
        "PolicyId": "cp-FullAliyunAccess",
        "CreateDate": "2020-08-05T06:32:24Z",
        "PolicyType": "System",
        "Tags": {
          "Tag": [
            {
              "Key": "tag_key",
              "Value": "tag_value"
            }
          ]
        },
        "ControlPolicyType": "RESOURCE_CONTROL_POLICY"
      }
    ]
  }
}

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.