DescribeSecurityGroupAttribute - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta os detalhes de um grupo de segurança especificado, incluindo a lista de regras do grupo de segurança.

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

ecs:DescribeSecurityGroupAttribute

get

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

ecs:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SecurityGroupId	string	Sim	O ID do grupo de segurança.	sg-bp1gxw6bznjjvhu3****
RegionId	string	Sim	O ID da região do grupo de segurança. Você pode chamar DescribeRegions(~~25609~~) para consultar a lista de regiões mais recente. DescribeRegions	cn-hangzhou
NicType	string	Não	O tipo de rede da regra do grupo de segurança. Para grupos de segurança em uma VPC, o único valor válido é intranet (padrão), que indica rede interna. Nota Se você definir este parâmetro como internet ou deixá-lo vazio, o valor será automaticamente definido como intranet. Valores válidos para grupos de segurança na rede clássica: internet (padrão): Internet. intranet: rede interna. Nota O recurso de rede clássica foi desativado. Para obter detalhes, consulte Anúncio de desativação.	intranet
Direction	string	Não	A direção da regra do grupo de segurança. Valores válidos: egress: saída. ingress: entrada. all: entrada e saída. Valor padrão: all.	all
NextToken	string	Não	O token de paginação. Defina este parâmetro com o valor NextToken retornado na chamada anterior. Você não precisa definir este parâmetro na primeira solicitação.	AAAAAdDWBF2****
MaxResults	integer	Não	O número máximo de entradas por página para uma consulta paginada. Valor mínimo: 10. Valor máximo: 1000. Valor padrão: 500.	500
Attribute	string	Não	O atributo do grupo de segurança. Valores válidos: snapshotPolicyIds: consulta as políticas de snapshot associadas ao grupo de segurança.	snapshotPolicyIds

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
VpcId	string	O ID da VPC. Se um ID de VPC for retornado, o tipo de rede do grupo de segurança será VPC. Caso contrário, o grupo de segurança pertence à rede clássica. Nota O recurso de rede clássica foi desativado. Para obter detalhes, consulte Anúncio de desativação.	vpc-bp1opxu1zkhn00gzv****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
InnerAccessPolicy	string	A política de conectividade de rede interna do grupo de segurança. Valores válidos: Accept: interconexão de serviços. Drop: isolamento interno.	Accept
Description	string	A descrição do grupo de segurança.	This is description.
SecurityGroupId	string	O ID do grupo de segurança.	sg-bp1gxw6bznjjvhu3****
SecurityGroupName	string	O nome do grupo de segurança.	SecurityGroupName Sample
RegionId	string	O ID da região.	cn-hangzhou
Permissions	object
Permission	array<object>	A coleção de regras do grupo de segurança.
	object
SecurityGroupRuleId	string	O ID da regra do grupo de segurança.	sgr-bp12kewq32dfwrdi****
Direction	string	A direção na qual a regra do grupo de segurança é aplicada.	ingress
SourceGroupId	string	O grupo de segurança de origem para controle de acesso de entrada.	sg-bp12kc4rqohaf2js****
DestGroupOwnerAccount	string	O ID da conta Alibaba Cloud à qual o grupo de segurança de destino pertence.	1234567890
DestPrefixListId	string	O ID da lista de prefixos de destino para controle de acesso de saída.	pl-x1j1k5ykzqlixabc****
DestPrefixListName	string	O nome da lista de prefixos de destino.	DestPrefixListName Sample
SourceCidrIp	string	O bloco CIDR de origem para controle de acesso de entrada.	0.0.0.0/0
Ipv6DestCidrIp	string	O bloco CIDR IPv6 de destino.	2001:db8:1233:1a00::***
CreateTime	string	A hora em que a regra do grupo de segurança foi criada. A hora é exibida em UTC.	2018-12-12T07:28:38Z
Ipv6SourceCidrIp	string	O bloco CIDR IPv6 de origem.	2001:db8:1234:1a00::***
DestGroupId	string	O ID do grupo de segurança de destino para controle de acesso de saída.	sg-bp1czdx84jd88i7v****
DestCidrIp	string	O bloco CIDR de destino para controle de acesso de saída.	0.0.0.0/0
IpProtocol	string	O protocolo da camada de transporte.	TCP
Priority	string	A prioridade da regra.	1
DestGroupName	string	O nome do grupo de segurança de destino.	testDestGroupName
NicType	string	O tipo de rede.	intranet
Policy	string	A política de controle de acesso.	Accept
Description	string	A descrição do grupo de segurança.	Description Sample 01
PortRange	string	O intervalo de portas.	80/80
SourcePrefixListName	string	O nome da lista de prefixos de origem.	SourcePrefixListName Sample
SourcePrefixListId	string	O ID da lista de prefixos de origem para controle de acesso de entrada.	pl-x1j1k5ykzqlixdcy****
SourceGroupOwnerAccount	string	O ID da conta Alibaba Cloud à qual o grupo de segurança de origem pertence.	1234567890
SourceGroupName	string	O nome do grupo de segurança de origem.	testSourceGroupName1
SourcePortRange	string	O intervalo de portas de origem.	80/80
PortRangeListId	string	O ID da lista de portas.	prl-2ze9743****
PortRangeListName	string	O nome da lista de portas.	PortRangeListNameSample
NextToken	string	O token de paginação retornado nesta chamada. Ao usar MaxResults e NextToken para consulta paginada, se este valor estiver vazio, não haverá mais dados disponíveis.	AAAAAdDWBF2****
SnapshotPolicyIds	object
SnapshotPolicyId	array	A lista de IDs de políticas de snapshot associadas ao grupo de segurança.
	string	O ID da política de snapshot associada ao grupo de segurança.	sgsp-mj74****

Exemplos

Resposta de sucesso

JSON formato

{
  "VpcId": "vpc-bp1opxu1zkhn00gzv****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "InnerAccessPolicy": "Accept",
  "Description": "This is description.",
  "SecurityGroupId": "sg-bp1gxw6bznjjvhu3****",
  "SecurityGroupName": "SecurityGroupName Sample",
  "RegionId": "cn-hangzhou",
  "Permissions": {
    "Permission": [
      {
        "SecurityGroupRuleId": "sgr-bp12kewq32dfwrdi****",
        "Direction": "ingress",
        "SourceGroupId": "sg-bp12kc4rqohaf2js****",
        "DestGroupOwnerAccount": "1234567890",
        "DestPrefixListId": "pl-x1j1k5ykzqlixabc****",
        "DestPrefixListName": "DestPrefixListName Sample",
        "SourceCidrIp": "0.0.0.0/0",
        "Ipv6DestCidrIp": "2001:db8:1233:1a00::***",
        "CreateTime": "2018-12-12T07:28:38Z",
        "Ipv6SourceCidrIp": "2001:db8:1234:1a00::***",
        "DestGroupId": "sg-bp1czdx84jd88i7v****",
        "DestCidrIp": "0.0.0.0/0",
        "IpProtocol": "TCP",
        "Priority": "1",
        "DestGroupName": "testDestGroupName",
        "NicType": "intranet",
        "Policy": "Accept",
        "Description": "Description Sample 01",
        "PortRange": "80/80",
        "SourcePrefixListName": "SourcePrefixListName Sample",
        "SourcePrefixListId": "pl-x1j1k5ykzqlixdcy****",
        "SourceGroupOwnerAccount": "1234567890",
        "SourceGroupName": "testSourceGroupName1",
        "SourcePortRange": "80/80",
        "PortRangeListId": "prl-2ze9743****",
        "PortRangeListName": "PortRangeListNameSample"
      }
    ]
  },
  "NextToken": "AAAAAdDWBF2****",
  "SnapshotPolicyIds": {
    "SnapshotPolicyId": [
      "sgsp-mj74****"
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	O parâmetro NicType especificado é inválido.
400	InvalidParamter	Invalid Parameter.	O parâmetro de entrada é inválido.
400	InvalidSecurityGroupId.Malformed	The specified parameter "SecurityGroupId" is not valid.	O parâmetro SecurityGroupId especificado é inválido.
400	MissingParameter.RegionId	The parameter RegionId is missing.
400	InvalidParameter.AttributeNotSupported	The specified value for parameter Attribute is not supported. Valid values: snapshotPolicyIds.	O valor especificado para o parâmetro Attribute não é compatível. Valores válidos: snapshotPolicyIds.
500	InternalError	The request processing has failed due to some unknown error.
500	ServiceUnavailable	The service is unavailable, please try again later.	A solicitação expirou. Tente novamente.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	As informações da região são inválidas.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	O grupo de segurança especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.