Todos os produtos
Search
Central de documentação

Object Storage Service:PutAccessPointConfigForObjectProcess

Última atualização: Jul 03, 2026

Modifique a configuração de um Object FC Access Point.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissão para modifique a configuração de um Object FC Access Point. Para executar essa operação como usuário RAM ou com credenciais do Security Token Service (STS), você precisa da permissão oss:PutAccessPointConfigForObjectProcess.

Sintaxe da solicitação

PUT /?accessPointConfigForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<PutAccessPointConfigForObjectProcessConfiguration>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <Actions>
          <Action>GetObject</Action>
        </Actions>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn>string</FunctionAssumeRoleArn>
            <FunctionArn>string</FunctionArn>
          </FunctionCompute>          
        </ContentTransformation>
      </TransformationConfiguration>
    </TransformationConfigurations>
  </ObjectProcessConfiguration>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</PutAccessPointConfigForObjectProcessConfiguration>

Cabeçalhos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

x-oss-access-point-for-object-process-name

String

Sim

fc-ap-01

Nome do Object FC Access Point. O nome deve atender aos seguintes requisitos:

  • Ter no máximo 63 caracteres.

  • Conter apenas letras minúsculas, dígitos e hifens (-). Não pode começar nem terminar com hífen (-).

  • Ser exclusivo na região atual.

Para obter mais informações sobre cabeçalhos comuns de solicitação, como Host e Date, consulte Cabeçalhos de resposta comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

PutAccessPointConfigForObjectProcessConfiguration

Contêiner

Sim

N/A

Contêiner que armazena a configuração do Object FC Access Point.

Nós pai: nenhum

Nós filho: AccessPointName e ObjectProcessConfiguration

ObjectProcessConfiguration

Contêiner

Não

N/A

Contêiner que armazena a configuração de processamento do Object FC Access Point.

Nós pai: PutAccessPointConfigForObjectProcessConfiguration

Nós filho: AllowedFeature e TransformationConfigurations

AllowedFeatures

Contêiner

Não

N/A

Contêiner que armazena os recursos permitidos.

Nós pai: ObjectProcessConfiguration

Nós filho: AllowedFeature

AllowedFeature

String

Não

GetObject-Range

Indica que o Function Compute oferece suporte a solicitações GetObject com Range.

Nós pai: AllowedFeatures

Nós filho: nenhum

TransformationConfigurations

Contêiner

Não

N/A

Contêiner que armazena as configurações de transformação.

Nós pai: ObjectProcessConfiguration

Nós filho: TransformationConfiguration

TransformationConfiguration

Contêiner

Não

N/A

Contêiner que armazena uma única configuração de transformação.

Nós pai: TransformationConfigurations

Nós filho: Actions e ContentTransformation

Actions

Contêiner

Não

N/A

Contêiner que armazena as operações.

Nós pai: TransformationConfiguration

Nós filho: Action

Action

String

Não

GetObject

Operação da API OSS a ser processada. Apenas GetObject é suportado.

Nós pai: Actions

Nós filho: nenhum

ContentTransformation

Contêiner

Não

N/A

Contêiner que armazena os detalhes da transformação de conteúdo.

Nós pai: TransformationConfiguration

Nós filho: FunctionCompute

FunctionCompute

Contêiner

Não

N/A

Contêiner que armazena a configuração do Function Compute.

Nós pai: ContentTransformation

Nós filho: FunctionAssumeRoleArn e FunctionArn

FunctionAssumeRoleArn

String

Não

acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole

ARN da função RAM assumida pelo OSS para acessar seus recursos do Function Compute. Padrão: AliyunOSSObjectFcForOSSDefaultRole. Para mais detalhes, consulte Criar rapidamente uma função.

Nós pai: FunctionCompute

Nós filho: nenhum

FunctionArn

String

Não

acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02

ARN da função a ser associada ao Object FC Access Point. Para mais detalhes, consulte Obter o ARN de uma função.

Nós pai: FunctionCompute

Nós filho: nenhum

PublicAccessBlockConfiguration

Contêiner

Sim

N/A

Contêiner que armazena a configuração de Bloqueio de Acesso Público.

Nós pai: PutAccessPointConfigForObjectProcessConfiguration

Nós filho: BlockPublicAccess

BlockPublicAccess

Boolean

Não

true

Define se o Bloqueio de Acesso Público deve ser ativado para o Object FC Access Point.

  • true: ative o Bloqueio de Acesso Público.

  • false (padrão): desativa o Bloqueio de Acesso Público.

Nós pai: PublicAccessBlockConfiguration

Nós filho: nenhum

Cabeçalhos de resposta

Esta operação retorna apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Cabeçalhos de resposta comuns.

Exemplos

  • Exemplo de solicitação

    PUT /?accessPointConfigForObjectProcess HTTP/1.1
    Date: GMT Date
    Content-Length: 750
    Content-Type: application/xml
    Host: oss-example.oss-cn-qingdao.aliyuncs.com
    x-oss-access-point-for-object-process-name: fc-ap-01
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <?xml version="1.0" encoding="UTF-8"?>
    <PutAccessPointConfigForObjectProcessConfiguration>
      <ObjectProcessConfiguration>
        <AllowedFeatures>
          <AllowedFeature>GetObject-Range</AllowedFeature>
        </AllowedFeatures>
        <TransformationConfigurations>
          <TransformationConfiguration>
            <Actions>
              <Action>GetObject</Action>
            </Actions>
            <ContentTransformation>
              <FunctionCompute>
                <FunctionAssumeRoleArn>acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole</FunctionAssumeRoleArn>
                <FunctionArn>acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02</FunctionArn>
              </FunctionCompute>          
            </ContentTransformation>
          </TransformationConfiguration>
        </TransformationConfigurations>
      </ObjectProcessConfiguration>
      <PublicAccessBlockConfiguration>
        <BlockPublicAccess>true</BlockPublicAccess>
      </PublicAccessBlockConfiguration>
    </PutAccessPointConfigForObjectProcessConfiguration>
  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D****
    Date: Mon, 30 Oct 2023 03:15:40 GMT