Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::CLOUDFW::AddressBooks

Última atualização: Jun 27, 2026

Consulta detalhes de catálogos de endereços para controle de acesso do Cloud Firewall.

Sintaxe

{
  "Type": "DATASOURCE::CLOUDFW::AddressBooks",
  "Properties": {
    "GroupType": String,
    "Lang": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

GroupType

String

Não

Sim

O tipo do catálogo de endereços.

Valores válidos:

  • ip: catálogo de endereços IP

  • domain: catálogo de endereços de domínio

  • port: catálogo de endereços de porta

  • tag: catálogo de endereços baseado em tags do Elastic Compute Service (ECS)

  • allCloud: catálogo de endereços de serviços em nuvem

  • threat: catálogo de endereços de inteligência de ameaças

Nota

Se você não especificar esta propriedade, o sistema consultará catálogos de endereços IP e catálogos de endereços baseados em tags do ECS.

Lang

String

Não

Sim

O idioma do conteúdo da requisição.

Valores válidos:

  • zh (padrão): Chinês

  • en: Inglês

RefreshOptions

String

Não

Sim

A política de atualização dos recursos de fonte de dados quando a stack é atualizada.

Valores válidos:

  • Never (padrão): não atualiza os recursos de fonte de dados quando a stack é atualizada.

  • Always: atualiza os recursos de fonte de dados quando a stack é atualizada.

Valores de retorno

Fn::GetAtt

  • AddressBooks: detalhes dos catálogos de endereços.

  • GroupUuids: os UUIDs dos catálogos de endereços.

Propriedade

Tipo

Descrição

Restrição

GroupUuids

List

Os UUIDs dos catálogos de endereços.

Nenhum.

AddressBooks

List

Detalhes dos catálogos de endereços.

Nenhum.

AutoAddTagEcs

String

Indica se os endereços IP públicos das instâncias do ECS que correspondem às tags especificadas são adicionados automaticamente ao catálogo de endereços. Esta propriedade se aplica a instâncias do ECS recém-adquiridas com configurações de tags concluídas e a instâncias do ECS com configurações de tags modificadas.

Valores válidos:

  • 1: Os endereços IP públicos das instâncias do ECS correspondentes são adicionados automaticamente ao catálogo de endereços.

  • 0: Os endereços IP públicos das instâncias do ECS correspondentes não são adicionados automaticamente ao catálogo de endereços.

Tags

List

Os detalhes da tag.

Nenhum.

GroupUuid

String

O UUID do catálogo de endereços.

Nenhum.

AddressListCount

String

O número de endereços no catálogo de endereços.

Nenhum.

GroupName

String

O nome do catálogo de endereços.

Nenhum.

ReferenceCount

String

O número de vezes que o catálogo de endereços é referenciado.

Nenhum.

TagRelation

String

A relação lógica entre as tags do ECS.

Valores válidos:

  • and: Somente os endereços IP públicos das instâncias do ECS que correspondem a todas as tags especificadas são adicionados ao catálogo de endereços.

  • or: Os endereços IP públicos das instâncias do ECS que correspondem a uma das tags especificadas são adicionados ao catálogo de endereços.

AddressList

List

Os endereços no catálogo de endereços.

Nenhum.

Description

String

A descrição do catálogo de endereços.

Nenhum.

GroupType

String

O tipo do catálogo de endereços.

Valores válidos:

  • ip: catálogo de endereços IP

  • domain: catálogo de endereços de domínio

  • port: catálogo de endereços de porta

  • tag: catálogo de endereços baseado em tags do ECS

  • allCloud: catálogo de endereços de serviços em nuvem

  • threat: catálogo de endereços de inteligência de ameaças

Exemplos

YAML formato

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  GroupType:
    AllowedValues:
    - ip
    - domain
    - port
    - tag
    Description:
      en: 'Address Book, it can be set to include:

        - **ip**: an IP address book

        - **domain**: domain name address book

        - **port**: port Address Book

        - **tag**:ECS tag address book.'
    Required: false
    Type: String
  Lang:
    Description:
      en: 'The language type of the received message.

        - **zh** (default): Chinese.

        - **en**: English.'
    Required: false
    Type: String
Resources:
  ExtensionDataSource:
    Properties:
      GroupType:
        Ref: GroupType
      Lang:
        Ref: Lang
    Type: DATASOURCE::CLOUDFW::AddressBooks
Outputs:
  AddressBooks:
    Description: The list of address books.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - AddressBooks
  GroupUuids:
    Description: The list of group uuids.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - GroupUuids
                        

JSON formato

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "GroupType": {
      "Type": "String",
      "Description": {
        "en": "Address Book, it can be set to include:\n- **ip**: an IP address book\n- **domain**: domain name address book\n- **port**: port Address Book\n- **tag**:ECS tag address book."
      },
      "AllowedValues": [
        "ip",
        "domain",
        "port",
        "tag"
      ],
      "Required": false
    },
    "Lang": {
      "Type": "String",
      "Description": {
        "en": "The language type of the received message.\n- **zh** (default): Chinese.\n- **en**: English."
      },
      "Required": false
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::CLOUDFW::AddressBooks",
      "Properties": {
        "GroupType": {
          "Ref": "GroupType"
        },
        "Lang": {
          "Ref": "Lang"
        }
      }
    }
  },
  "Outputs": {
    "AddressBooks": {
      "Description": "The list of address books.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "AddressBooks"
        ]
      }
    },
    "GroupUuids": {
      "Description": "The list of group uuids.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "GroupUuids"
        ]
      }
    }
  }
}