---
title: "PUT /{scope}/providers/Microsoft.CustomProviders/associations/{associationName}"
method: PUT
path: "/{scope}/providers/Microsoft.CustomProviders/associations/{associationName}"
tags: ["Associations"]
---

# PUT /{scope}/providers/Microsoft.CustomProviders/associations/{associationName}

`PUT /{scope}/providers/Microsoft.CustomProviders/associations/{associationName}`

Create or update an association.

## Path parameters

- `scope` string, required
- `associationName` string, required

## Query parameters

- `api-version` string, required

## Request body

- Association — The resource definition of this association.
  - `id` string — The association id.
  - `name` string — The association name.
  - `type` string — The association type.
  - `properties` object — The properties of the association.
    - `targetResourceId` string — The REST resource instance of the target resource for this association.
    - `provisioningState` 'Accepted' | 'Deleting' | 'Running' | 'Succeeded' | 'Failed' — The provisioning state of the association.

## Response `200`

OK. Association already exists and the changes have been accepted.

- Association — The resource definition of this association.
  - `id` string — The association id.
  - `name` string — The association name.
  - `type` string — The association type.
  - `properties` object — The properties of the association.
    - `targetResourceId` string — The REST resource instance of the target resource for this association.
    - `provisioningState` 'Accepted' | 'Deleting' | 'Running' | 'Succeeded' | 'Failed' — The provisioning state of the association.

## Other responses

- `201` — Created. Association has been created.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/customproviders.md) · [All operations](https://skmtc.net/azure/apis/customproviders/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/customproviders/revisions/9642048d6ded/schema)