GetCheckStructure - Security Center: Central de Documentação do Alibaba Cloud

Consulta a estrutura de diretório da lista de itens de verificação.

Descrição da operação

O recurso de verificação de configuração da plataforma em nuvem requer uma compra antes do uso.

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

yundun-sas:GetCheckStructure

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CurrentPage	integer	Não	O número da página atual em uma consulta paginada.	1
PageSize	integer	Não	O número máximo de entradas por página em uma consulta paginada.	20
Lang	string	Não	O tipo de idioma para solicitações e respostas. Valor padrão: zh. Valores válidos: zh: Chinês en: Inglês.	zh
RegionId	string	Não	A região onde o ativo reside. Valores válidos: cn-hangzhou: China ap-southeast-1: fora da China.	cn-hangzhou
TaskSources	array	Não	A lista de origens de tarefas.
	string	Não	A origem da tarefa. Valores válidos: YAO_CHI: ApsaraDB.	YAO_CHI

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	LGetCheckStructureResponse.
CheckStructureResponse	array<object>	As informações de estrutura dos itens de verificação de configuração da plataforma em nuvem.
	array<object>
StandardType	string	O tipo de negócio do item de verificação de configuração da plataforma em nuvem. Valores válidos: RISK: risco de segurança IDENTITY_PERMISSION: gerenciamento de permissões CIEM COMPLIANCE: conformidade de segurança.	RISK
Standards	array<object>	As informações de estrutura dos itens de verificação sob o tipo de negócio.
	array<object>
Requirements	array<object>	The standards of the cloud platform configuration check items.
	array<object>
Id	integer	The ID of the cloud platform configuration check item requirement.	46
ShowName	string	The name of the cloud platform configuration check item requirement.	Networking
TotalCheckCount	integer	The total number of check items under the requirement.	36
Sections	array<object>	The sections of the check items.
	object	The ID of the check item section.
Id	integer	The ID of the check item section.	177
ShowName	string	The name of the check item section.	Access Control
Id	integer	The ID of the cloud platform configuration check item standard.	8
Type	string	The business type corresponding to the cloud platform configuration check item standard. Valid values: RISK: security risk IDENTITY_PERMISSION: permission management CIEM COMPLIANCE: security compliance.	IDENTITY_PERMISSION
ShowName	string	The name of the cloud platform configuration check item standard.	Alibaba Cloud best security practices
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.	379a9b8f-107b-4630-9e95-2299a1ea****

Exemplos

Resposta de sucesso

JSON formato

{
  "CheckStructureResponse": [
    {
      "StandardType": "RISK",
      "Standards": [
        {
          "Requirements": [
            {
              "Id": 46,
              "ShowName": "Networking",
              "TotalCheckCount": 36,
              "Sections": [
                {
                  "Id": 177,
                  "ShowName": "Access Control"
                }
              ]
            }
          ],
          "Id": 8,
          "Type": "IDENTITY_PERMISSION",
          "ShowName": "Alibaba Cloud best security practices"
        }
      ]
    }
  ],
  "RequestId": "379a9b8f-107b-4630-9e95-2299a1ea****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	ServerError	ServerError
403	NoPermission	caller has no permission

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.