Updates a channel partner link. Distributors call this method to change a link's status. For example, to suspend a partner link. You must be a distributor to call this method.
Possible error codes:
PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request.
INVALID_ARGUMENT:
Required request parameters are missing or invalid.
Link state cannot change from invited to active or suspended.
Cannot send resellerCloudIdentityId, invite_url, or name in update mask.
NOT_FOUND: ChannelPartnerLink resource not found.
INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.
UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.
Required. The resource name of the channel partner link to cancel. Name uses the format: accounts/{account_id}/channelPartnerLinks/{id} where {id} is the Cloud Identity ID of the partner.
Request body
The request body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-19 UTC."],[[["\u003cp\u003eThis method updates the status of a channel partner link, allowing distributors to modify a link's state, such as suspending it.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003ePATCH\u003c/code\u003e method with a specific URL structure, defined as \u003ccode\u003ehttps://cloudchannel.googleapis.com/v1/{name=accounts/*/channelPartnerLinks/*}\u003c/code\u003e and requires a channel partner link name in the \u003ccode\u003eaccounts/{account_id}/channelPartnerLinks/{id}\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003echannelPartnerLink\u003c/code\u003e object, which specifies the link to update, and an \u003ccode\u003eupdateMask\u003c/code\u003e that is specifically set to \u003ccode\u003echannelPartnerLink.link_state\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, if successful, will provide the updated \u003ccode\u003eChannelPartnerLink\u003c/code\u003e resource, and only distributors are authorized to call this method.\u003c/p\u003e\n"],["\u003cp\u003ePotential error codes include \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e, \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e, \u003ccode\u003eNOT_FOUND\u003c/code\u003e, \u003ccode\u003eINTERNAL\u003c/code\u003e, and \u003ccode\u003eUNKNOWN\u003c/code\u003e, indicating various issues such as incorrect reseller accounts, invalid parameters, or internal errors.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.channelPartnerLinks.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a channel partner link. Distributors call this method to change a link's status. For example, to suspend a partner link. You must be a distributor to call this method.\n\nPossible error codes:\n\n- PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request.\n- INVALID_ARGUMENT:\n - Required request parameters are missing or invalid.\n - Link state cannot change from invited to active or suspended.\n - Cannot send resellerCloudIdentityId, invite_url, or name in update mask.\n- NOT_FOUND: ChannelPartnerLink resource not found.\n- INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.\n- UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.\n\nReturn value: The updated [ChannelPartnerLink](/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink) resource.\n\n### HTTP request\n\n`PATCH https://cloudchannel.googleapis.com/v1/{name=accounts/*/channelPartnerLinks/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [ChannelPartnerLink](/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]