naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure DataShareManagementClient — Share
  description: 'Microsoft Azure DataShareManagementClient — Share. 10 operations. Lead operation: Microsoft Azure List Of
    Available Shares Under An Account. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Share
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: datasharemanagementclient-share
    baseUri: https://management.azure.com
    description: Microsoft Azure DataShareManagementClient — Share business capability. Self-contained, no shared references.
    resources:
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares
      operations:
      - name: microsoftazureshareslistbyaccount
        method: GET
        description: Microsoft Azure List Of Available Shares Under An Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $skipToken
          in: query
          type: string
          description: Continuation Token
        - name: $filter
          in: query
          type: string
          description: Filters the results using OData syntax.
        - name: $orderby
          in: query
          type: string
          description: Sorts the results using OData syntax.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}
      operations:
      - name: microsoftazuresharesget
        method: GET
        description: Microsoft Azure Get A Specified Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share to retrieve.
          required: true
      - name: microsoftazuresharescreate
        method: PUT
        description: Microsoft Azure Create A Share In The Given Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: share
          in: body
          type: string
          description: The share payload
          required: true
      - name: microsoftazuresharesdelete
        method: DELETE
        description: Microsoft Azure Deletes A Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizationDetails
      operations:
      - name: microsoftazureshareslistsynchronizationdetails
        method: POST
        description: Microsoft Azure List Data Set Level Details For A Share Synchronization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: shareSynchronization
          in: body
          type: string
          description: Share Synchronization payload.
          required: true
        - name: $skipToken
          in: query
          type: string
          description: Continuation token
        - name: $filter
          in: query
          type: string
          description: Filters the results using OData syntax.
        - name: $orderby
          in: query
          type: string
          description: Sorts the results using OData syntax.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizations
      operations:
      - name: microsoftazureshareslistsynchronizations
        method: POST
        description: Microsoft Azure List Synchronizations In A Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: $skipToken
          in: query
          type: string
          description: Continuation token
        - name: $filter
          in: query
          type: string
          description: Filters the results using OData syntax.
        - name: $orderby
          in: query
          type: string
          description: Sorts the results using OData syntax.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions
      operations:
      - name: microsoftazureprovidersharesubscriptionslistbyshare
        method: GET
        description: Microsoft Azure List Of Available Share Subscriptions To A Provider Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: $skipToken
          in: query
          type: string
          description: Continuation Token
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}
      operations:
      - name: microsoftazureprovidersharesubscriptionsgetbyshare
        method: GET
        description: Microsoft Azure Get Share Subscription In A Provider Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: providerShareSubscriptionId
          in: path
          type: string
          description: To locate shareSubscription
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/reinstate
      operations:
      - name: microsoftazureprovidersharesubscriptionsreinstate
        method: POST
        description: Microsoft Azure Reinstate Share Subscription In A Provider Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: providerShareSubscriptionId
          in: path
          type: string
          description: To locate shareSubscription
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/revoke
      operations:
      - name: microsoftazureprovidersharesubscriptionsrevoke
        method: POST
        description: Microsoft Azure Revoke Share Subscription In A Provider Share
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shareName
          in: path
          type: string
          description: The name of the share.
          required: true
        - name: providerShareSubscriptionId
          in: path
          type: string
          description: To locate shareSubscription
          required: true
  exposes:
  - type: rest
    namespace: datasharemanagementclient-share-rest
    port: 8080
    description: REST adapter for Microsoft Azure DataShareManagementClient — Share. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureshareslistbyaccount
        description: Microsoft Azure List Of Available Shares Under An Account
        call: datasharemanagementclient-share.microsoftazureshareslistbyaccount
        with:
          $skipToken: rest.$skipToken
          $filter: rest.$filter
          $orderby: rest.$orderby
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazuresharesget
        description: Microsoft Azure Get A Specified Share
        call: datasharemanagementclient-share.microsoftazuresharesget
        with:
          shareName: rest.shareName
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazuresharescreate
        description: Microsoft Azure Create A Share In The Given Account
        call: datasharemanagementclient-share.microsoftazuresharescreate
        with:
          shareName: rest.shareName
          share: rest.share
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuresharesdelete
        description: Microsoft Azure Deletes A Share
        call: datasharemanagementclient-share.microsoftazuresharesdelete
        with:
          shareName: rest.shareName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/listsynchronizationdetails
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureshareslistsynchronizationdetails
        description: Microsoft Azure List Data Set Level Details For A Share Synchronization
        call: datasharemanagementclient-share.microsoftazureshareslistsynchronizationdetails
        with:
          shareName: rest.shareName
          shareSynchronization: rest.shareSynchronization
          $skipToken: rest.$skipToken
          $filter: rest.$filter
          $orderby: rest.$orderby
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/listsynchronizations
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureshareslistsynchronizations
        description: Microsoft Azure List Synchronizations In A Share
        call: datasharemanagementclient-share.microsoftazureshareslistsynchronizations
        with:
          shareName: rest.shareName
          $skipToken: rest.$skipToken
          $filter: rest.$filter
          $orderby: rest.$orderby
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/providersharesubscriptions
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureprovidersharesubscriptionslistbyshare
        description: Microsoft Azure List Of Available Share Subscriptions To A Provider Share
        call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionslistbyshare
        with:
          shareName: rest.shareName
          $skipToken: rest.$skipToken
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/providersharesubscriptions/{providersharesubscriptionid}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureprovidersharesubscriptionsgetbyshare
        description: Microsoft Azure Get Share Subscription In A Provider Share
        call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsgetbyshare
        with:
          shareName: rest.shareName
          providerShareSubscriptionId: rest.providerShareSubscriptionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/providersharesubscriptions/{providersharesubscriptionid}/reinstate
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureprovidersharesubscriptionsreinstate
        description: Microsoft Azure Reinstate Share Subscription In A Provider Share
        call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsreinstate
        with:
          shareName: rest.shareName
          providerShareSubscriptionId: rest.providerShareSubscriptionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-datashare/accounts/{accountname}/shares/{sharename}/providersharesubscriptions/{providersharesubscriptionid}/revoke
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureprovidersharesubscriptionsrevoke
        description: Microsoft Azure Revoke Share Subscription In A Provider Share
        call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsrevoke
        with:
          shareName: rest.shareName
          providerShareSubscriptionId: rest.providerShareSubscriptionId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: datasharemanagementclient-share-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure DataShareManagementClient — Share. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-list-available-shares
      description: Microsoft Azure List Of Available Shares Under An Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasharemanagementclient-share.microsoftazureshareslistbyaccount
      with:
        $skipToken: tools.$skipToken
        $filter: tools.$filter
        $orderby: tools.$orderby
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-specified-share
      description: Microsoft Azure Get A Specified Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasharemanagementclient-share.microsoftazuresharesget
      with:
        shareName: tools.shareName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-share-given
      description: Microsoft Azure Create A Share In The Given Account
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: datasharemanagementclient-share.microsoftazuresharescreate
      with:
        shareName: tools.shareName
        share: tools.share
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-share
      description: Microsoft Azure Deletes A Share
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: datasharemanagementclient-share.microsoftazuresharesdelete
      with:
        shareName: tools.shareName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-data-set
      description: Microsoft Azure List Data Set Level Details For A Share Synchronization
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: datasharemanagementclient-share.microsoftazureshareslistsynchronizationdetails
      with:
        shareName: tools.shareName
        shareSynchronization: tools.shareSynchronization
        $skipToken: tools.$skipToken
        $filter: tools.$filter
        $orderby: tools.$orderby
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-synchronizations-share
      description: Microsoft Azure List Synchronizations In A Share
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: datasharemanagementclient-share.microsoftazureshareslistsynchronizations
      with:
        shareName: tools.shareName
        $skipToken: tools.$skipToken
        $filter: tools.$filter
        $orderby: tools.$orderby
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-available-share
      description: Microsoft Azure List Of Available Share Subscriptions To A Provider Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionslistbyshare
      with:
        shareName: tools.shareName
        $skipToken: tools.$skipToken
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-share-subscription
      description: Microsoft Azure Get Share Subscription In A Provider Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsgetbyshare
      with:
        shareName: tools.shareName
        providerShareSubscriptionId: tools.providerShareSubscriptionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-reinstate-share-subscription
      description: Microsoft Azure Reinstate Share Subscription In A Provider Share
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsreinstate
      with:
        shareName: tools.shareName
        providerShareSubscriptionId: tools.providerShareSubscriptionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-revoke-share-subscription
      description: Microsoft Azure Revoke Share Subscription In A Provider Share
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasharemanagementclient-share.microsoftazureprovidersharesubscriptionsrevoke
      with:
        shareName: tools.shareName
        providerShareSubscriptionId: tools.providerShareSubscriptionId
      outputParameters:
      - type: object
        mapping: $.