Skip to main content

get-attribute-attribution-set 

dci get-attribute-attribution-set <attributionSetId>

Returns one attribution (Attribution Center set) with its latest rule version. Get attributionSetId from listAttributeAttributionSets. An unknown or deleted set returns 404 not_found.

Authenticate with Authorization: Bearer &lt;token&gt;. Omit X-Tenant-Id when the credential resolves to one customer. When the credential can act on several customers, send X-Tenant-Id: &lt;tenant-id&gt; to select one.

  • attributionSetId — The attributionSetId of an attribution from listAttributeAttributionSets.

Output​

OK - The attribution.

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

FieldTypeDescription
attributionSetIdstringThe attribution's ID. In Cloud Analytics reports, use it with - replaced by _ as the id of the attribution_tier_1, attribution_tier_2 and attribution_tier_3 dimensions.
namestring
descriptionstring
ruleIdstringID of the latest rule version.
versionintegerNumber of the latest rule version.
updatedAtstring (date-time)When the latest rule version was saved.
ruleobjectOne rule version of an attribution: how its cost is split into values. Older versions can miss fields; only attributionSetId is always present.
rule.attributionSetIdstring
rule.statestringOne of: "ui-draft", "etl-ready", "deleted", "discarded".
rule.dateRangeobjectThe days the rules apply to, as a half-open range [startDate, endDate).
rule.dateRange.startDatestring (date)
rule.dateRange.endDatestring (date)Exclusive. Null or absent means open-ended.
rule.scopearray of objectFilters that limit the cost the attribution works on; all must match.
rule.billingFiltersByBucketarray of objectThe rules per bucket (a service, usage account or provider): billing conditions, sensor conditions and what happens to the remaining cost.
activeRuleIdstringID of the newest published (etl-ready) rule version; null when there is none.
Raw JSON schema
{
  "type": "object",
  "required": [
    "attributionSetId",
    "name",
    "description",
    "ruleId",
    "rule"
  ],
  "properties": {
    "attributionSetId": {
      "type": "string",
      "description": "The attribution's ID. In Cloud Analytics reports, use it with `-` replaced by `_` as the\nid of the `attribution_tier_1`, `attribution_tier_2` and `attribution_tier_3` dimensions."
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "ruleId": {
      "type": "string",
      "description": "ID of the latest rule version."
    },
    "version": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of the latest rule version."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When the latest rule version was saved."
    },
    "rule": {
      "type": "object",
      "description": "One rule version of an attribution: how its cost is split into values. Older versions can\nmiss fields; only `attributionSetId` is always present.",
      "required": [
        "attributionSetId"
      ],
      "properties": {
        "attributionSetId": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "ui-draft",
            "etl-ready",
            "deleted",
            "discarded"
          ],
          "x-enumDescriptions": {
            "ui-draft": "A draft that is not applied to cost.",
            "etl-ready": "Published; applied to cost.",
            "deleted": "The attribution was deleted.",
            "discarded": "A discarded draft."
          }
        },
        "dateRange": {
          "type": "object",
          "description": "The days the rules apply to, as a half-open range [startDate, endDate).",
          "required": [
            "startDate"
          ],
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date"
            },
            "endDate": {
              "type": "string",
              "format": "date",
              "nullable": true,
              "description": "Exclusive. Null or absent means open-ended."
            }
          }
        },
        "scope": {
          "type": "array",
          "description": "Filters that limit the cost the attribution works on; all must match.",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "billingFiltersByBucket": {
          "type": "array",
          "description": "The rules per bucket (a service, usage account or provider): billing conditions, sensor\nconditions and what happens to the remaining cost.",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        }
      }
    },
    "activeRuleId": {
      "type": "string",
      "nullable": true,
      "description": "ID of the newest published (`etl-ready`) rule version; null when there is none."
    }
  }
}

Errors​

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP status to exit code mapping
HTTP statusExit codeError codeMeaning
40030VALIDATION_ERRORThe arguments or request body were rejected. Review the command's flags and payload.
40110AUTHENTICATION_FAILEDNot signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
40311PERMISSION_DENIEDThe DoiT user or the active customer context does not have access.
40420RESOURCE_NOT_FOUNDThe requested resource does not exist. Check the identifier argument.
40921RESOURCE_CONFLICTThe operation conflicts with the resource's current state.
500, 502, 50340API_SERVER_ERRORThe API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: getattributeattributionset