URI HTTP methods Schemas Properties See also

Backend appId Storage backendEnvironmentName

Update a storage resource in your Amplify app backend.

URI

/prod/backend/appId/storage/backendEnvironmentName

HTTP methods

POST

Operation ID: UpdateBackendStorage

Updates an existing backend storage resource.

Path parameters
Name	Type	Required	Description
`appId`	String	True	The app ID.
`backendEnvironmentName`	String	True	The name of the backend environment.

Responses
Status code	Response model	Description
`200`	`BackendStorageRespObj`	200 response
`400`	`BadRequestException`	400 response
`404`	`NotFoundException`	404 response
`429`	`LimitExceededException`	429 response
`504`	`InternalServiceException`	504 response

OPTIONS

Enables CORS by returning the correct headers.

Path parameters
Name	Type	Required	Description
`appId`	String	True	The app ID.
`backendEnvironmentName`	String	True	The name of the backend environment.

Responses
Status code	Response model	Description
`200`	None	200 response

Schemas

Request bodies


{
  "resourceConfig": {
    "permissions": {
      "authenticated": [
        enum
      ],
      "unAuthenticated": [
        enum
      ]
    },
    "serviceName": enum
  },
  "resourceName": "string"
}

Response bodies


{
  "jobId": "string",
  "appId": "string",
  "backendEnvironmentName": "string",
  "status": "string"
}


{
  "message": "string"
}


{
  "message": "string",
  "resourceType": "string"
}


{
  "message": "string",
  "limitType": "string"
}


{
  "message": "string"
}

Properties

BackendStoragePermissions

Describes the read, write, and delete permissions users have against your storage S3 bucket.

Property Type Required Description

Property	Type	Required	Description
`authenticated`	Array of type string Values: `READ \| CREATE_AND_UPDATE \| DELETE`	True	Lists all authenticated user read, write, and delete permissions for your S3 bucket.
`unAuthenticated`	Array of type string Values: `READ \| CREATE_AND_UPDATE \| DELETE`	False	Lists all unauthenticated user read, write, and delete permissions for your S3 bucket.

authenticated

Array of type string

Values: READ | CREATE_AND_UPDATE | DELETE

True

Lists all authenticated user read, write, and delete permissions for your S3 bucket.

unAuthenticated

Array of type string

Values: READ | CREATE_AND_UPDATE | DELETE

False

Lists all unauthenticated user read, write, and delete permissions for your S3 bucket.

BackendStorageRespObj

The response object for this operation.

Property	Type	Required	Description
`appId`	string	True	The app ID.
`backendEnvironmentName`	string	True	The name of the backend environment.
`jobId`	string	True	The ID for the job.
`status`	string	True	The current status of the request.

BadRequestException

An error returned if a request is not formed properly.

Property	Type	Required	Description
`message`	string	False	An error message to inform that the request failed.

InternalServiceException

An error returned if there's a temporary issue with the service.

Property	Type	Required	Description
`message`	string	False	An error message to inform that the request failed.

LimitExceededException

An error that is returned when a limit of a specific type has been exceeded.

Property	Type	Required	Description
`limitType`	string	False	The type of limit that was exceeded.
`message`	string	False	An error message to inform that the request has failed.

NotFoundException

An error returned when a specific resource type is not found.

Property	Type	Required	Description
`message`	string	False	An error message to inform that the request has failed.
`resourceType`	string	False	The type of resource that is not found.

UpdateBackendStorageReqObj

The request object for this operation.

Property	Type	Required	Description
`resourceConfig`	UpdateBackendStorageResourceConfig	True	The resource configuration for updating backend storage.
`resourceName`	string	True	The name of the storage resource.

UpdateBackendStorageResourceConfig

The resource configuration for updating backend storage.

Property Type Required Description

Property	Type	Required	Description
`permissions`	BackendStoragePermissions	True	The authorization configuration for the storage S3 bucket.
`serviceName`	string Values: `S3`	True	The name of the storage service.

permissions

BackendStoragePermissions

True

The authorization configuration for the storage S3 bucket.

serviceName

string

Values: S3

True

The name of the storage service.