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

Lista os itens de verificação personalizados de conscientização situacional.

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:ListCheckItems

get

*CustomCheckItem

acs:yundun-sas:{#regionId}:{#accountId}:customcheckitem/{#CheckId}

Nenhuma

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CheckId	integer	Não	O ID do item de verificação.	100000000001
CheckShowName	string	Não	O nome do item de verificação personalizado.	testCheckItemName
CheckTypes	array	Não	O tipo de origem do item de verificação de conscientização situacional.
	string	Não	O tipo do item de verificação (identifica se a política é um item de verificação do sistema ou um item de verificação do usuário): CUSTOM: Definido pelo usuário SYSTEM: Definido pelo sistema	SYSTEM
Lang	string	Não	O tipo de idioma para solicitações e respostas. O valor padrão é zh. Valores válidos: zh: Chinês en: Inglês	zh
Statuses	array	Não	O status do item de verificação.
	string	Não	O status do item de verificação. Valores válidos: EDIT: Em edição RELEASE: Lançado	RELEASE
PageSize	integer	Não	Especifica o número máximo de entradas de dados a serem exibidas por página ao realizar uma consulta paginada. O número padrão de entradas de dados exibidas por página é 20 e, se o parâmetro PageSize estiver vazio, o padrão será retornar 20 entradas de dados. Nota Recomenda-se não deixar o valor de PageSize vazio.	20
CurrentPage	integer	Não	Especifica o número da página a ser exibido ao realizar uma consulta paginada. O valor inicial é 1 e o valor padrão é 1.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta da API.
RequestId	string	O ID da solicitação atual, que é um identificador exclusivo gerado pelo Alibaba Cloud para esta solicitação e pode ser usado para solução de problemas e localização de problemas.	7BC55C8F-226E-5AF5-9A2C-2EC43864****
CheckItems	array<object>	Informações sobre os itens de verificação.
	array<object>	Informações sobre os itens de verificação.
CheckId	integer	O ID do item de verificação.	100000000001
CheckShowName	string	O nome do item de verificação.	testCheckItemName
Vendor	string	O fornecedor do ativo em nuvem.	ALIYUN
InstanceType	string	O tipo de ativo do produto em nuvem.	ECS
InstanceSubType	string	O subtipo do ativo do produto em nuvem.	DISK
RiskLevel	string	O nível de risco do item de verificação. Valores válidos: HIGH: Alto risco MEDIUM: Risco médio LOW: Baixo risco	HIGH
Status	string	O status do item de verificação. Valores válidos: EDIT: Em edição RELEASE: Lançado	EDIT
CheckPolicies	array<object>	Uma lista de informações de padrões, regulamentações e seções associadas ao resultado da verificação.
	object	Informações sobre os padrões, regulamentações e capítulos associados aos resultados da verificação.
StandardId	integer	Standard ID of the inspection item.	10000000001
StandardShowName	string	The display name of the standard for the check item.	testStandardShowName
RequirementId	integer	The ID of the requirement for the check item.	10000000001
RequirementShowName	string	The display name of the requirement for the check item.	testRequirementShowName
SectionId	integer	The ID of the section for the check item.	10000000001
SectionShowName	string	The display name of the section for the check item.	testSectionShowName
Type	string	The name of the associated policy category: AISPM:AI Configuration Management (AI-SPM) KISPM:Kubernetes Configuration Management (KSPM) IDENTITY_PERMISSION:Identity and Permission Management (CIEM) RISK:Security Risk COMPLIANCE:Compliance Risk	AISPM
Description	object	As informações de descrição do item de verificação.
Type	string	The type of the check description attribute. Values: text:Text	text
Value	string	The specific content of the description.	custom description.
Solution	object	As informações de solução para o item de verificação.
Type	string	The type of the check item solution information. Values: text:Text	text
Value	string	The content of the solution for the check item risk.	test solution.
AssistInfo	object	As informações de ajuda para o item de verificação.
Type	string	The type of the help information for the check item risk. Values: text:Text	text
Value	string	The content of the help information for the check item risk.	test assistInfo.
CheckRule	string	Define regras para itens de verificação personalizados.	{"AssociatedData":{"ToDataList":[{"DataName":"ACS_ECS_Instance","PropertyPath":"InstanceId","FromPropertyPath":"InstanceId"}]},"MatchProperty":{"Operator":"AND","MatchProperties":[{"DataName":"ACS_ECS_Disk","PropertyPath":"InstanceId","MatchOperator":"EQ","MatchPropertyValue":"testId"},{"DataName":"ACS_ECS_Instance","PropertyPath":"InstanceId","MatchOperator":"EQ","MatchPropertyValue":"testInstanceId"}]}}
CheckType	string	O tipo de origem do item de verificação do Security Posture: CUSTOM: Definido pelo usuário SYSTEM: Predefinido pela plataforma Security Posture	SYSTEM
Remark	string	Informações de observação.	remark.
PageInfo	object	Informações de página para consultas paginadas.
TotalCount	integer	O número total de entradas de dados encontradas.	100
Count	integer	O número de entradas de dados exibidas na página atual em uma consulta paginada.	20
CurrentPage	integer	O número da página atual ao realizar uma consulta paginada.	1
PageSize	integer	O número máximo de registros exibidos por página ao realizar uma consulta paginada.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "7BC55C8F-226E-5AF5-9A2C-2EC43864****",
  "CheckItems": [
    {
      "CheckId": 100000000001,
      "CheckShowName": "testCheckItemName",
      "Vendor": "ALIYUN",
      "InstanceType": "ECS",
      "InstanceSubType": "DISK",
      "RiskLevel": "HIGH",
      "Status": "EDIT",
      "CheckPolicies": [
        {
          "StandardId": 10000000001,
          "StandardShowName": "testStandardShowName",
          "RequirementId": 10000000001,
          "RequirementShowName": "testRequirementShowName",
          "SectionId": 10000000001,
          "SectionShowName": "testSectionShowName",
          "Type": "AISPM"
        }
      ],
      "Description": {
        "Type": "text",
        "Value": "custom description."
      },
      "Solution": {
        "Type": "text",
        "Value": "test solution."
      },
      "AssistInfo": {
        "Type": "text",
        "Value": "test assistInfo."
      },
      "CheckRule": "{\"AssociatedData\":{\"ToDataList\":[{\"DataName\":\"ACS_ECS_Instance\",\"PropertyPath\":\"InstanceId\",\"FromPropertyPath\":\"InstanceId\"}]},\"MatchProperty\":{\"Operator\":\"AND\",\"MatchProperties\":[{\"DataName\":\"ACS_ECS_Disk\",\"PropertyPath\":\"InstanceId\",\"MatchOperator\":\"EQ\",\"MatchPropertyValue\":\"testId\"},{\"DataName\":\"ACS_ECS_Instance\",\"PropertyPath\":\"InstanceId\",\"MatchOperator\":\"EQ\",\"MatchPropertyValue\":\"testInstanceId\"}]}}",
      "CheckType": "SYSTEM",
      "Remark": "remark."
    }
  ],
  "PageInfo": {
    "TotalCount": 100,
    "Count": 20,
    "CurrentPage": 1,
    "PageSize": 20
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ParamIllegal.%s	The parameter %s is invalid, please fill it in again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.