CreateAccessPointForObjectProcess - Object Storage Service - Centre de documentation Alibaba Cloud

Crée un point d'accès Object FC.

Notes d'utilisation

Par défaut, un compte Alibaba Cloud est autorisé à créer des points d'accès Object FC. Pour en créer un avec un utilisateur RAM ou via le Security Token Service (STS), l'autorisation oss:CreateAccessPointForObjectProcess est requise.
Un compte Alibaba Cloud peut comporter jusqu'à 1 000 points d'accès Object FC.
Un bucket peut comporter jusqu'à 100 points d'accès Object FC.

Syntaxe de la requête

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>

En-têtes de requête

En-tête

Type

Obligatoire

Exemple

Description

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

String

Oui

fc-ap-01

Nom du point d'accès Object FC. Le nom doit respecter les exigences suivantes :

Il ne doit pas dépasser 63 caractères.
Il ne peut contenir que des lettres minuscules, des chiffres et des traits d'union (-) et ne doit ni commencer ni se terminer par un trait d'union (-).
Il doit être unique dans la région actuelle.

Pour plus d'informations sur les en-têtes de requête courants tels que Host et Date, consultez la section En-têtes HTTP courants.

Éléments de requête

Élément	Type	Obligatoire	Exemple	Description
CreateAccessPointForObjectProcessConfiguration	Container	Oui	S.O.	Conteneur qui stocke les informations relatives au point d'accès Object FC. Nœuds parents : aucun Nœuds enfants : AccessPointName et ObjectProcessConfiguration
AccessPointName	String	Oui	ap-01	Nom du point d'accès Object FC. Pour plus d'informations, consultez la rubrique Créer des points d'accès Object FC.
ObjectProcessConfiguration	Container	Non	S.O.	Conteneur qui stocke les informations de traitement du point d'accès Object FC. Nœuds parents : CreateAccessPointForObjectProcessConfiguration Nœuds enfants : AllowedFeature et TransformationConfigurations
AllowedFeatures	Container	Non	S.O.	Conteneur qui stocke les fonctionnalités autorisées. Nœuds parents : ObjectProcessConfiguration Nœuds enfants : AllowedFeature
AllowedFeature	String	Non	GetObject-Range	Indique que Function Compute prend en charge les requêtes GetObject avec plage (Range). Nœuds parents : AllowedFeatures Nœuds enfants : aucun
TransformationConfigurations	Container	Non	S.O.	Conteneur qui stocke les configurations de transformation. Nœuds parents : ObjectProcessConfiguration Nœuds enfants : TransformationConfiguration
TransformationConfiguration	Container	Non	S.O.	Conteneur qui stocke les configurations de transformation. Nœuds parents : TransformationConfigurations Nœuds enfants : Actions et ContentTransformation
Actions	Container	Non	S.O.	Conteneur qui stocke les opérations. Nœuds parents : TransformationConfiguration Nœuds enfants : Action
Action	String	Non	GetObject	Opération API OSS. Seule l'opération GetObject est prise en charge. Nœuds parents : Actions Nœuds enfants : aucun
ContentTransformation	Container	Non	S.O.	Conteneur qui stocke le contenu des configurations de transformation. Nœuds parents : TransformationConfiguration Nœuds enfants : FunctionCompute
FunctionCompute	Container	Non	S.O.	Conteneur qui stocke les informations relatives à Function Compute. Nœuds parents : ContentTransformation Nœuds enfants : FunctionAssumeRoleArn et FunctionArn
FunctionAssumeRoleArn	String	Non	acs:ram::111933544165****:role/aliyunfcdefaultrole	Alibaba Cloud Resource Name (ARN) du rôle utilisé par Function Compute pour accéder à vos ressources dans d'autres services cloud. Le rôle par défaut est `AliyunFCDefaultRole`. Pour plus d'informations, consultez la rubrique Créer rapidement une fonction. Nœuds parents : FunctionCompute Nœuds enfants : aucun
FunctionArn	String	Non	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	ARN de la fonction. Pour plus d'informations, consultez la section Obtenir l'ARN d'une fonction.

En-têtes de réponse

Cette opération renvoie uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez la section En-têtes HTTP courants.

Éléments de réponse

Élément

Type

Exemple

Description

CreateAccessPointForObjectProcessResult

Container

S.O.

Conteneur qui stocke les informations relatives au point d'accès Object FC.

Nœuds enfants : AccessPointForObjectProcessArn et Alias

AccessPointForObjectProcessArn

String

acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01

ARN du point d'accès Object FC.

AccessPointForObjectProcessAlias

String

fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias

Alias du point d'accès Object FC.

Exemples

Exemple de requête

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>

Exemple de réponse

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>