Updated on 2026-09-23 GMT+08:00

Deleting an Image Sharing Policy

Function

Delete an image sharing policy.

Constraints

N/A

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    swr:repo:deleteRepoShare

    Permission_management

    repo *

    -

    -

    -

URI

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.

repository

Yes

String

Image repository name. The name contains 1 to 128 characters, starting and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), slashes (/), underscores (_), and hyphens (-) are allowed. Periods, slashes, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. If the parameter value contains a slash (/), replace it with a dollar sign ($) before sending the request.

share_id

Yes

String

Image sharing policy ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Possible values:

application/json;charset=utf-8

application/json

X-Auth-Token

Yes

String

User token.

It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 204

None

Example Requests

DELETE https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}

Example Responses

None

Status Codes

Status Code

Description

204

Deleted.

400

Bad request.

401

Unauthorized.

500

Internal error.

Error Codes

See Error Codes.