CreateAccessPointForObjectProcess - Object Storage Service - Centro de documentación de Alibaba Cloud

Cree un Object FC Access Point.

Notas de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos para crear Object FC Access Points. Para crear uno mediante un usuario de RAM o Security Token Service (STS), debe contar con el permiso oss:CreateAccessPointForObjectProcess.
Se pueden crear hasta 1,000 Object FC Access Points por cuenta de Alibaba Cloud.
Se pueden crear hasta 100 Object FC Access Points por bucket.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

Encabezado

Tipo

Obligatorio

Ejemplo

Descripción

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

String

Sí

fc-ap-01

Nombre del Object FC Access Point. Debe cumplir los siguientes requisitos:

La longitud no puede exceder los 63 caracteres.
Solo puede contener letras minúsculas, dígitos y guiones (-), y no puede comenzar ni terminar con un guion (-).
Debe ser único en la región actual.

Para obtener más información sobre encabezados de solicitud comunes como Host y Date, consulte Common HTTP headers.

Elementos de la solicitud

Elemento	Tipo	Obligatorio	Ejemplo	Descripción
CreateAccessPointForObjectProcessConfiguration	Container	Sí	N/A	Contenedor que almacena la información del Object FC Access Point. Nodos padre: ninguno Nodos hijo: AccessPointName y ObjectProcessConfiguration
AccessPointName	String	Sí	ap-01	Nombre del Object FC Access Point. Para obtener más información, consulte Create Object FC Access Points.
ObjectProcessConfiguration	Container	No	N/A	Contenedor que almacena la información de procesamiento del Object FC Access Point. Nodos padre: CreateAccessPointForObjectProcessConfiguration Nodos hijo: AllowedFeature y TransformationConfigurations
AllowedFeatures	Container	No	N/A	Contenedor que almacena las funciones permitidas. Nodos padre: ObjectProcessConfiguration Nodos hijo: AllowedFeature
AllowedFeature	String	No	GetObject-Range	Indica que Function Compute admite solicitudes GetObject con Range. Nodos padre: AllowedFeatures Nodos hijo: ninguno
TransformationConfigurations	Container	No	N/A	Contenedor que almacena las configuraciones de transformación. Nodos padre: ObjectProcessConfiguration Nodos hijo: TransformationConfiguration
TransformationConfiguration	Container	No	N/A	Contenedor que almacena las configuraciones de transformación. Nodos padre: TransformationConfigurations Nodos hijo: Actions y ContentTransformation
Actions	Container	No	N/A	Contenedor que almacena las operaciones. Nodos padre: TransformationConfiguration Nodos hijo: Action
Action	String	No	GetObject	Operación de la API de OSS. Solo se admite GetObject. Nodos padre: Actions Nodos hijo: ninguno
ContentTransformation	Container	No	N/A	Contenedor que almacena el contenido de las configuraciones de transformación. Nodos padre: TransformationConfiguration Nodos hijo: FunctionCompute
FunctionCompute	Container	No	N/A	Contenedor que almacena la información de Function Compute. Nodos padre: ContentTransformation Nodos hijo: FunctionAssumeRoleArn y FunctionArn
FunctionAssumeRoleArn	String	No	acs:ram::111933544165****:role/aliyunfcdefaultrole	Alibaba Cloud Resource Name (ARN) del rol que utiliza Function Compute para acceder a sus recursos en otros servicios en la nube. El rol predeterminado es `AliyunFCDefaultRole`. Para obtener más información, consulte Quickly create a function. Nodos padre: FunctionCompute Nodos hijo: ninguno
FunctionArn	String	No	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	ARN de la función. Para obtener más información, consulte Get a function ARN.

Encabezados de la respuesta

Esta operación solo devuelve encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP headers.

Elementos de la respuesta

Elemento	Tipo	Ejemplo	Descripción
CreateAccessPointForObjectProcessResult	Container	N/A	Contenedor que almacena la información del Object FC Access Point. Nodos hijo: AccessPointForObjectProcessArn y Alias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01	ARN del Object FC Access Point.
AccessPointForObjectProcessAlias	String	fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias	Alias del Object FC Access Point.

Ejemplos

Solicitud de ejemplo

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>

Respuesta de ejemplo

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>