DescribeSecurityGroupAttribute - - Centro de documentación de Alibaba Cloud

Consulta las reglas de un security group.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos invocar esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeSecurityGroupAttribute	La operación que desea ejecutar. Establezca el valor en DescribeSecurityGroupAttribute.
SecurityGroupId	String	Sí	sg-bp1gxw6bznjjvhu3****	El ID del security group.
RegionId	String	Sí	cn-hangzhou	El ID de región del security group. Invoque la operación DescribeRegions para consultar la lista más reciente de regiones.
NicType	String	No	intranet	El tipo de controlador de interfaz de red (NIC) de la regla del security group. Valores válidos para reglas de security groups en la red clásica: internet: valor predeterminado para security groups en la red clásica. intranet Nota Solo puede consultar reglas de security group de un tipo de NIC por llamada. Para consultar reglas de ambos tipos de NIC, invoque la operación dos veces. Si el security group se encuentra en una virtual private cloud (VPC), establezca el valor en intranet. Este también es el valor predeterminado para security groups en la VPC. Nota Si establece este parámetro en internet o lo deja vacío, se utiliza automáticamente el valor intranet.
Direction	String	No	all	La dirección en la que se aplica la regla del security group. Valores válidos: egress: salida ingress: entrada all: salida y entrada Valor predeterminado: all.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
VpcId	String	vpc-bp1opxu1zkhn00gzv****	El ID de la VPC. Si se devuelve un ID de VPC, el tipo de red del security group es VPC. Si no se devuelve ningún ID de VPC, el tipo de red del security group es red clásica.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
InnerAccessPolicy	String	Accept	La directiva de control de acceso del security group. Valores válidos: Accept: Todas las instancias del security group pueden comunicarse entre sí. Drop: Todas las instancias del security group están aisladas entre sí.
Description	String	This is description.	La descripción del security group.
SecurityGroupId	String	sg-bp1gxw6bznjjvhu3****	El ID del security group de destino.
SecurityGroupName	String	SecurityGroupName Sample	El nombre del security group de destino.
RegionId	String	cn-hangzhou	El ID de la región.
Permissions	Array of Permission		Detalles sobre las reglas del security group.
Permission
SecurityGroupRuleId	String	sgr-bp12kewq32dfwrdi****	El ID de la regla del security group.
Direction	String	ingress	La dirección en la que se aplica la regla del security group.
SourceGroupId	String	sg-bp12kc4rqohaf2js****	El security group de origen para el control de acceso de entrada.
DestGroupOwnerAccount	String	1234567890	La cuenta de Alibaba Cloud que administra el security group de destino.
DestPrefixListId	String	pl-x1j1k5ykzqlixabc****	El ID de la lista de prefijos de destino para el control de acceso de salida.
DestPrefixListName	String	DestPrefixListName Sample	El nombre de la lista de prefijos de destino.
SourceCidrIp	String	0.0.0.0/0	El bloque CIDR de origen para el control de acceso de entrada.
Ipv6DestCidrIp	String	2001:db8:1233:1a00::***	El bloque CIDR IPv6 de destino.
CreateTime	String	2018-12-12T07:28:38Z	La hora en que se creó la regla del security group. La hora se muestra en formato UTC.
Ipv6SourceCidrIp	String	2001:db8:1234:1a00::***	El bloque CIDR IPv6 de origen.
DestGroupId	String	sg-bp1czdx84jd88i7v****	El ID del security group de destino para el control de acceso de salida.
DestCidrIp	String	0.0.0.0/0	Los bloques CIDR de destino para el control de acceso de salida.
IpProtocol	String	TCP	El protocolo de la capa de transporte.
Priority	String	1	La prioridad de la regla.
DestGroupName	String	testDestGroupName	El nombre del security group de destino.
NicType	String	intranet	El tipo de red.
Policy	String	Accept	La directiva de control de acceso.
Description	String	Description Sample 01	La descripción del security group.
PortRange	String	80/80	El rango de puertos.
SourcePrefixListName	String	SourcePrefixListName Sample	El nombre de la lista de prefijos de origen.
SourcePrefixListId	String	pl-x1j1k5ykzqlixdcy****	El ID de la lista de prefijos de origen para el control de acceso de entrada.
SourceGroupOwnerAccount	String	1234567890	La cuenta de Alibaba Cloud que administra el security group de origen.
SourceGroupName	String	testSourceGroupName1	El nombre del security group de origen.
SourcePortRange	String	80/80	El rango de números de puerto de origen.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?RegionId=cn-hangzhou
&SecurityGroupId=sg-bp1gxw6bznjjvhu3****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSecurityGroupAttributeResponse>
    <SecurityGroupId>sg-bp1gxw6bznjjvhu3****</SecurityGroupId>
    <InnerAccessPolicy>Accept</InnerAccessPolicy>
    <SecurityGroupName>SecurityGroupName Sample</SecurityGroupName>
    <Description>This is description.</Description>
    <RegionId>cn-hangzhou</RegionId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <Permissions>
        <Permission>
            <SecurityGroupRuleId>sgr-bp12swerrtfcy****</SecurityGroupRuleId>
            <SourceCidrIp>0.0.0.0/0</SourceCidrIp>
            <Description>Description Sample 01</Description>
            <DestCidrIp/>
            <NicType>intranet</NicType>
            <DestGroupName/>
            <PortRange>22/22</PortRange>
            <DestGroupId/>
            <Ipv6DestCidrIp/>
            <DestPrefixListId/>
            <DestPrefixListName/>
            <Direction>ingress</Direction>
            <Priority>1</Priority>
            <IpProtocol>TCP</IpProtocol>
            <SourcePortRange/>
            <SourceGroupOwnerAccount/>
            <Policy>Accept</Policy>
            <CreateTime>2018-12-12T07:28:38Z</CreateTime>
            <SourceGroupId/>
            <DestGroupOwnerAccount/>
            <Ipv6SourceCidrIp/>
            <SourceGroupName/>
            <SourcePrefixListId/>
            <SourcePrefixListName/>
        </Permission>
    </Permissions>
    <VpcId>vpc-bp1opxu1zkhn00gzv****</VpcId>
</DescribeSecurityGroupAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SecurityGroupId" : "sg-bp1gxw6bznjjvhu3****",
  "InnerAccessPolicy" : "Accept",
  "SecurityGroupName" : "SecurityGroupName Sample",
  "Description" : "This is description.",
  "RegionId" : "cn-hangzhou",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Permissions" : {
    "Permission" : [ {
      "SecurityGroupRuleId" : "sgr-bp12swerrtfcy****",
      "SourceCidrIp" : "0.0.0.0/0",
      "Description" : "Description Sample 01",
      "DestCidrIp" : "",
      "NicType" : "intranet",
      "DestGroupName" : "",
      "PortRange" : "22/22",
      "DestGroupId" : "",
      "Ipv6DestCidrIp" : "",
      "DestPrefixListId" : "",
      "DestPrefixListName" : "",
      "Direction" : "ingress",
      "Priority" : 1,
      "IpProtocol" : "TCP",
      "SourcePortRange" : "",
      "SourceGroupOwnerAccount" : "",
      "Policy" : "Accept",
      "CreateTime" : "2018-12-12T07:28:38Z",
      "SourceGroupId" : "",
      "DestGroupOwnerAccount" : "",
      "Ipv6SourceCidrIp" : "",
      "SourceGroupName" : "",
      "SourcePrefixListId" : "",
      "SourcePrefixListName" : ""
    } ]
  },
  "VpcId" : "vpc-bp1opxu1zkhn00gzv****"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	El mensaje de error devuelto porque el parámetro NicType especificado no existe.
400	InvalidParamter	Invalid Parameter	El mensaje de error devuelto porque un parámetro especificado no es válido.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	El mensaje de error devuelto porque el parámetro RegionId especificado no existe.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	El mensaje de error devuelto porque el security group especificado no existe en esta cuenta. Compruebe si el ID del security group es correcto.
500	InternalError	The request processing has failed due to some unknown error.	El mensaje de error devuelto porque ocurrió un error interno. Inténtelo de nuevo más tarde. Si el error persiste, envíe un ticket.

Para obtener una lista de códigos de error, consulte los Códigos de error del servicio.