Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::RAM::Groups

Última atualização: Jun 27, 2026

Consulta grupos de usuários do Resource Access Management (RAM).

Sintaxe

{
  "Type": "DATASOURCE::RAM::Groups",
  "Properties": {
    "GroupName": String,
    "UserName": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

GroupName

String

Não

Sim

Nome do grupo de usuários.

Aceita os caracteres curinga asterisco (*) e ponto de interrogação (?) para correspondência aproximada.

UserName

String

Não

Sim

Nome do usuário RAM no grupo de usuários.

Nenhuma.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos da source de dados ao atualizar a pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos da source de dados ao atualizar a pilha.

  • Always: atualiza os recursos da source de dados ao atualizar a pilha.

Valores de retorno (Fn::GetAtt)

  • GroupNames: nomes dos grupos de usuários.

  • Groups: detalhes dos grupos de usuários.

Propriedade

Tipo

Descrição

Restrição

GroupNames

List

Nomes dos grupos de usuários.

Nenhuma.

Groups

List

Detalhes dos grupos de usuários.

Nenhuma.

Comments

String

Observações.

Nenhuma.

GroupId

String

ID do grupo de usuários.

Nenhuma.

GroupName

String

Nome do grupo de usuários.

Nenhuma.

CreateDate

String

Data e hora de criação do grupo de usuários, em UTC.

Nenhuma.

Exemplos

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "GroupName": {
      "Type": "String",
      "Description": "Filter the results by a specific group name. Supports using * and ?  to fuzzy match.",
      "Default": "mdc-****"
    }
  },
  "Resources": {
    "Groups": {
      "Type": "DATASOURCE::RAM::Groups",
      "Properties": {
        "GroupName": {
          "Ref": "GroupName"
        }
      }
    }
  },
  "Outputs": {
    "GroupNames": {
      "Description": "The list of group names.",
      "Value": {
        "Fn::GetAtt": [
          "Groups",
          "GroupNames"
        ]
      }
    },
    "Groups": {
      "Description": "The list of groups.",
      "Value": {
        "Fn::GetAtt": [
          "Groups",
          "Groups"
        ]
      }
    }
  }
}