Todos os produtos
Search
Central de documentação

Object Storage Service:create-access-point

Última atualização: Jul 03, 2026

O comando create-access-point configura access points para um bucket.

Observações

  • A conta Alibaba Cloud tem autorização automática para criar access points. Para criar access points com um usuário RAM ou o Security Token Service (STS), você precisa da permissão oss:CreateAccessPoint. Para obter instruções detalhadas, consulte conceder política personalizada a um usuário RAM.

  • É possível criar até 1.000 access points por conta Alibaba Cloud.

  • Cada bucket aceita no máximo 100 access points.

Sintaxe

ossutil api create-access-point --bucket value --create-access-point-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--create-access-point-configuration

string

Contêiner que armazena as informações do access point.

Nota

O comando create-access-point corresponde à operação da API CreateAccessPoint. Para mais detalhes sobre os parâmetros, consulte CreateAccessPoint.

--create-access-point-configuration

A opção --create-access-point-configuration aceita os formatos XML e JSON. Se o valor contiver o prefixo 'file://', o sistema lê os parâmetros de configuração do arquivo especificado.

  • Formato XML:

    <CreateAccessPointConfiguration>
      <VpcConfiguration>
        <VpcId>string</VpcId>
      </VpcConfiguration>
      <AccessPointName>string</AccessPointName>
      <NetworkOrigin>string</NetworkOrigin>
    </CreateAccessPointConfiguration>
  • Formato JSON:

    {
      "AccessPointName": "string",
      "NetworkOrigin": "string",
      "VpcConfiguration": {
        "VpcId": "string"
      }
    }
Nota

Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplo

O código a seguir mostra como configurar um access point chamado 'ap-01' associado ao bucket examplebucket:

  • Crie um arquivo de configuração chamado create-access-point-configuration.xml e adicione o seguinte código:

    <?xml version="1.0" encoding="UTF-8"?>
    <CreateAccessPointConfiguration>
        <AccessPointName>ap-01</AccessPointName>
        <NetworkOrigin>internet</NetworkOrigin>
    </CreateAccessPointConfiguration>

    Comando de exemplo:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-point-configuration.xml
  • Crie um arquivo de configuração chamado create-access-point-configuration.json e adicione o seguinte código:

    {
      "AccessPointName": "ap-01",
      "NetworkOrigin": "internet"
    }

    Comando de exemplo:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-monitor-configuration.json
  • Configure os parâmetros diretamente no comando em formato JSON:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration  "{\"AccessPointName\":\"ap-01\",\"NetworkOrigin\":\"internet\"}"