CreateAccessPointForObjectProcess - Object Storage Service: Central de Documentação do Alibaba Cloud

Crie um Object FC Access Point.

Observações de uso

Por padrão, a conta Alibaba Cloud tem permissão para criar Object FC Access Points. Para criá-los com um usuário RAM ou o Security Token Service (STS), você precisa da permissão oss:CreateAccessPointForObjectProcess.
É possível criar até 1.000 Object FC Access Points por conta Alibaba Cloud.
Cada bucket aceita no máximo 100 Object FC Access Points.

Sintaxe da solicitação

PUT /?accessPointForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: 785
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"?>
<CreateAccessPointForObjectProcessConfiguration>
  <AccessPointName>ap-01</AccessPointName>
  <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>
</CreateAccessPointForObjectProcessConfiguration>

Cabeçalhos da solicitação

Cabeçalho

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 HTTP comuns.

Elementos da solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
CreateAccessPointForObjectProcessConfiguration	Contêiner	Sim	N/A	Contêiner que armazena as informações do Object FC Access Point. Nós pai: nenhum Nós filho: AccessPointName e ObjectProcessConfiguration
AccessPointName	String	Sim	ap-01	Nome do Object FC Access Point. Para mais detalhes, consulte Criar Object FC Access Points.
ObjectProcessConfiguration	Contêiner	Não	N/A	Contêiner com os dados de processamento do Object FC Access Point. Nós pai: CreateAccessPointForObjectProcessConfiguration Nós filho: AllowedFeature e TransformationConfigurations
AllowedFeatures	Contêiner	Não	N/A	Contêiner que lista os recursos permitidos. Nós pai: ObjectProcessConfiguration Nós filho: AllowedFeature
AllowedFeature	String	Não	GetObject-Range	Indica que o Function Compute aceita solicitações GetObject com Range. Nós pai: AllowedFeatures Nós filho: nenhum
TransformationConfigurations	Contêiner	Não	N/A	Contêiner que agrupa as configurações de transformação. Nós pai: ObjectProcessConfiguration Nós filho: TransformationConfiguration
TransformationConfiguration	Contêiner	Não	N/A	Define uma configuração específica de transformação. Nós pai: TransformationConfigurations Nós filho: Actions e ContentTransformation
Actions	Contêiner	Não	N/A	Contêiner que especifica as operações aplicáveis. Nós pai: TransformationConfiguration Nós filho: Action
Action	String	Não	GetObject	Operação da API OSS compatível. Apenas GetObject é aceito. Nós pai: Actions Nós filho: nenhum
ContentTransformation	Contêiner	Não	N/A	Contêiner com o conteúdo das configurações de transformação. Nós pai: TransformationConfiguration Nós filho: FunctionCompute
FunctionCompute	Contêiner	Não	N/A	Contêiner que armazena os dados do Function Compute. Nós pai: ContentTransformation Nós filho: FunctionAssumeRoleArn e FunctionArn
FunctionAssumeRoleArn	String	Não	acs:ram::111933544165****:role/aliyunfcdefaultrole	ARN (Alibaba Cloud Resource Name) da função usada pelo Function Compute para acessar seus recursos em outros serviços de nuvem. A função padrão é `AliyunFCDefaultRole`. Para saber mais, veja Criar rapidamente uma função. Nós pai: FunctionCompute Nós filho: nenhum
FunctionArn	String	Não	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	ARN da função. Consulte Obter o ARN de uma função para mais informações.

Cabeçalhos da resposta

Esta operação retorna apenas cabeçalhos comuns de resposta. Para mais detalhes, consulte Cabeçalhos HTTP comuns.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
CreateAccessPointForObjectProcessResult	Contêiner	N/A	Contêiner que armazena as informações do Object FC Access Point criado. Nós filho: AccessPointForObjectProcessArn e Alias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01	ARN do Object FC Access Point.
AccessPointForObjectProcessAlias	String	fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias	Alias do Object FC Access Point.

Exemplos

Exemplo de solicitação

PUT /?accessPointForObjectProcess HTTP/1.1
Date: Mon, 30 Oct 2023 03:15:40 GMT
Content-Length: 785
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"?>
<CreateAccessPointForObjectProcessConfiguration>
  <AccessPointName>ap-01</AccessPointName>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <Actions>
          <Action>GetObject</Action>
        </Actions>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn>acs:ram::111933544165****:role/aliyunfcdefaultrole</FunctionAssumeRoleArn>
            <FunctionArn>acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01</FunctionArn>
          </FunctionCompute>          
        </ContentTransformation>
      </TransformationConfiguration>
    </TransformationConfigurations>
  </ObjectProcessConfiguration>
</CreateAccessPointForObjectProcessConfiguration>

Exemplo de resposta

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 30 Oct 2023 03:15:40 GMT
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessResult>
  <AccessPointForObjectProcessArn>acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn>
  <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
</CreateAccessPointForObjectProcessResult>